Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODLinkSpec

ReadLinkSpec

The ReadLinkSpec method initializes this empty link specification by reading its data from the specified focused storage unit.

void ReadLinkSpec (in ODStorageUnit su);

su

A reference to the storage unit whose focused value contains the link-specification data.

DISCUSSION

If your part is a destination part, you create an empty link specification by calling the draft's CreateLinkSpec method, passing null for the source part and data parameters. Then, call the empty link specification's ReadLinkSpec method to initialize the link specification from data in the content storage unit of the clipboard or drag-and-drop object. The storage unit should be focused on the value of type kODLinkSpec in the kODPropLinkSpec property.

EXCEPTIONS

kODErrCorruptLinkSpecValue

The focused storage unit contains an invalid link- specification value.

kODErrNoLinkSpecValue

The focused property does not contain a link- specification value.

kODErrOutOfMemory

There is not enough memory to read the link specification.

kODErrUnknownLinkSpecVersion

The link-specification version is not recognized.

SEE ALSO

The ODDraft::CreateLinkSpec method (page 166).
The ODLinkSpec::WriteLinkSpec method (page 393).
"Creating a Link at the Destination" on page 380 in OpenDoc Programmer's Guide.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help